Skip to content

feat: add ee skill command to set up ee for AI coding agents#2

Merged
n1rna merged 2 commits into
mainfrom
feat/ee-skill-command
Jul 3, 2026
Merged

feat: add ee skill command to set up ee for AI coding agents#2
n1rna merged 2 commits into
mainfrom
feat/ee-skill-command

Conversation

@n1rna

@n1rna n1rna commented Jul 3, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a new ee skill <agent> command that installs an agent-oriented ee usage guide (the "ee-usage" skill) into the convention each coding agent expects. This replaces the "copy llms.txt around" workflow with a first-class, per-agent setup command.

Agent Install path Format
claude .claude/skills/ee-usage/SKILL.md Skill w/ YAML frontmatter
cursor .cursor/rules/ee-usage.mdc Rule w/ YAML frontmatter
copilot .github/copilot-instructions.md Plain markdown
codex AGENTS.md Plain markdown
opencode AGENTS.md Plain markdown
all every supported agent

What's in the guide

The guide is embedded in the binary (internal/command/assets/ee-usage.md) and is the single source of truth. It's derived from llms.txt but restructured for agents, with dedicated sections for:

  • Adding ee to a new project — step-by-step (init, schema, .env, verify, gitignore)
  • Working with an existing ee project — detect .ee, read config, apply/verify, add vars/envs, push secrets, secret-safety notes
  • File formats (.ee, schema, .env) and the full command reference

Command

ee skill claude          # install for one agent
ee skill all             # install for every agent
ee skill --list          # list supported agents
ee skill claude --print  # preview without writing
ee skill cursor --force  # overwrite existing file

Flags: --force, --list, --print, --quiet. Existing files are never overwritten without --force; all dedupes shared paths (codex/opencode both use AGENTS.md).

Docs

  • README.md: new AI Coding Agent Integration section; corrected the stale command list; swapped the llms.txt badge for an AI-skill badge.
  • llms.txt: added an "AI Coding Agent Skill" section and an ee skill command reference.

Tests

  • Go unit tests (internal/command/skill_test.go): target/path resolution, frontmatter wrappers, embedded body sections, stable agent ordering.
  • Python integration tests (tests/test_skill.py, 14 cases): per-agent install, all, --list, --print, unknown/missing agent errors, and force-overwrite behavior.

All suites pass: go test ./... (11 pkgs) and uv run pytest (31 tests).

🤖 Generated with Claude Code

n1rna and others added 2 commits July 3, 2026 23:18
…agents

Introduce `ee skill <agent>` which installs an agent-oriented ee usage
guide (the "ee-usage" skill) into the convention each coding agent
expects:

  claude   -> .claude/skills/ee-usage/SKILL.md (skill frontmatter)
  cursor   -> .cursor/rules/ee-usage.mdc        (rule frontmatter)
  copilot  -> .github/copilot-instructions.md   (plain markdown)
  codex    -> AGENTS.md                          (plain markdown)
  opencode -> AGENTS.md                          (plain markdown)
  all      -> every supported agent

The guide is embedded in the binary (internal/command/assets/ee-usage.md)
and derived from llms.txt, restructured for agents with dedicated
sections for adding ee to a new project and working with a project that
already has ee configured, plus the full command reference.

Supports --force, --list, --print and --quiet. Documentation (README and
llms.txt) updated to describe this setup flow.

Covered by Go unit tests (target resolution, frontmatter) and Python
integration tests (install per agent, all, flags, error handling).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@n1rna
n1rna merged commit 4736338 into main Jul 3, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant